home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 20 / Cream of the Crop 20 (Terry Blount) (1996).iso / comm / oh10a7.zip / CGI-BIN / VISITOR.TXT < prev   
Text File  |  1996-05-19  |  4KB  |  119 lines
  1. Visitor.exe .05 - A .CGI program for the masses...:)
  2.  
  3. I ask absolutely nothing for this program except that if you find the 
  4. time, to come by my site and check it out (it's listed below).
  5.  
  6. I.      Intro
  7. II.     Known Conflicts
  8. III.    Setup
  9. IV.     Problems?
  10. V.      Future Updates
  11.  
  12. ------------------------
  13.  
  14. I. Intro
  15. --------
  16. Ok, You've got you're pretty home page all set up and ready to go but 
  17. you've seen those cool little counters on other people's homepages and
  18. wanted to put one on your's too.  Well, I wrote one that simply reads 
  19. a number from a text file, creates an odometer image of it, adds one 
  20. to it, and write it back to the file (visitor.exe) and one that doesn't
  21. increment the file, just displays the number (noadd.exe).  Here is a 
  22. step-by-step guide to setting it up for your server.
  23.  
  24.  
  25. II.  Known Conflicts/Restrictions
  26. ---------------------------------
  27. I should get this out of the way right now.  Since this is being
  28. distributed with OmniHTTPd this shouldn't be a problem but this 
  29. program ("visitor.exe") is compiled to run under DOS/95/(NT probably)
  30. only.  If you would be interested in the source code.  Just drop me 
  31. an email. I have compiled the code on Unix as well with no/minimal
  32. changes.  
  33.  
  34. OmniHTTPd, as of Alpha 7, runs cgi's out of there directory.  So if you
  35. just reference it as <IMG SRC="/CGI-BIN/visitor.exe">, it will create a
  36. default count.txt in the CGI-BIN subdirectory.  You can pass the file a
  37. complete pathname to access files in other directories.
  38.  
  39. This also eliminates the need for the count file to be named "count.txt"
  40. in order to run successfully.
  41.  
  42. III.  Setup
  43. -----------
  44. Here's a quick and dirty setup guide to running visitor.exe on your 
  45. web server.
  46.  
  47. A. Copy the "visitor.exe" and "noadd.exe" to the CGI-BIN subdirectory 
  48.    of your httpd directory.
  49.  
  50. B. Make sure that in the OmniHTTPd Administration program, under 
  51.    "Standard CGI", there is an entry for "/CGI-BIN" as the virtual
  52.    and "C:\HTTPD\CGI-BIN" for actual (or whatever you specified the 
  53.    directory to be).
  54.  
  55. C. Reference it in your page like this:
  56.    <IMG SRC="/CGI-BIN/visitor.exe?filename.txt"> or
  57.    <IMG SRC="/CGI-BIN/noadd.exe?filename.txt">
  58.  
  59.    "filename.txt" can be whatever you want, including full pathname 
  60.    with directories with "/" slashes (i.e. "/httpd/htdocs/joe/count.txt")
  61.  
  62. D. Now go test it out!
  63.  
  64. IV. Problems? Suggestions?
  65. --------------------------
  66.  
  67. Now since you didn't pay for this, I don't have a toll-free technical
  68. support line to help you (Not that Microsoft has one mind you) but I 
  69. will try to help you out if I can.  Keep in mind that I am a student as
  70. well and as much as I would like computer time to come first, it can't
  71. always.  Also, any suggestions are welcome. My current email is 
  72. "reflux@u.washington.edu" and my server is at 
  73. "http://reflux.mcm.housing.washington.edu".
  74.  
  75. V. Future Updates
  76. -----------------
  77. I will dedicate a page on my server for a while to it.  Check them for
  78. updates.
  79.  
  80. Pages:
  81. http://reflux.mcm.housing.washington.edu/visitor
  82.   This will be up till summer.
  83. http://weber.u.washington.edu/~reflux/visitor
  84.   This will be up as long as I go to the University of Washington.
  85.  
  86. Things added:
  87.  
  88. Ver .05
  89. * I think I fixed the problem of multiple versions crashing if more
  90.   than one copy tries to access the file at the same time.
  91.  
  92. Ver .04
  93. * Fixed a floating point bug.
  94. * Added the "noadd.exe" program.  It just echos the amount of users 
  95.   but doesn't add to the file.  Used exactly the same as the visitor.exe
  96.  
  97. Ver .03
  98. * Notcied that I used an int to store the number so when you get to 
  99.   32768 visitors, it resets you to -32768 so I made it a float and
  100.   now you can have 10^38 visitors...:)  It only takes another 2 bytes
  101.   of memory so I figured it was worth it.
  102.  
  103. Ver .02
  104. * Optional file specification
  105. * Automatic creation of the count file if non-existent with 1 in it
  106.  
  107. DISCLAIMER
  108. ----------
  109.  
  110. Now I know that this part sucks but I have to do it.
  111.  
  112. Garrick and I are in no way responsible for what happens from the use
  113. of this program.  I wrote it myself and use it on my server so there
  114. are no viruses in it and it will not intentionally harm your system 
  115. but in using it, you accept the risk that something MIGHT happen and 
  116. agree not to hold anyone but yourself responsible.
  117.  
  118. Whew...I hate that crap.  I hope you have fun with the program and let
  119. me know if you're using it!